home *** CD-ROM | disk | FTP | other *** search
/ Apple Developer Connection 1998 Fall: Game Toolkit / Disc.iso / SDKs / Mac OS USB DDK_v1.0.1 / Mac OS USB v1.0.1 Readme < prev    next >
Encoding:
Text File  |  1998-09-03  |  3.9 KB  |  96 lines  |  [ttro/ttxt]
  1.  ***
  2.  ***       Universal Serial Bus(tm) (USB) for the Mac OS
  3.  ***    Mac OS USB 1.0.1 DDK Change History Notes
  4.  ***    Copyright 1998 Apple Computer, Inc.
  5.  ***
  6.  
  7.  Table of Contents:
  8. -------------------------------------------------------------
  9.  Changes from USB v1.0 -> v1.0.1
  10.  Changes/Additions to the USB v1.0.1 DDK
  11.  Known Issues
  12. -------------------------------------------------------------
  13.  
  14. Changes from USB v1.0 -> v1.0.1
  15. -------------------------------
  16.  
  17. The following changes were made for USB 1.0.1
  18.  
  19. 1. USB.h
  20.  - Removed the call USBGetConnectionIDByClass as its usefulness is limited.
  21.    Use the USBGetNextDeviceByClass call instead so that you can interate
  22.    through the available devices.
  23.  - Added a number of Hub Defines that were previously in a private interface
  24.    file.
  25.  
  26. 2. Addressed the following bugs
  27.  - Fixed several USBBulkRead issues which includes the lost print band problem.
  28.  
  29.  - UIM buffer alignment fix.  The UIM (USBOpenHCIDriver) could cause a 
  30.    class driver to receive a -6908 error if the buffer passed in was not 
  31.    aligned on a "MaxPacketSized" boundary.  We have sent out
  32.    information on how to workaround this to developers, this fix will 
  33.    remove this restriction. This problem can only occur when reading 
  34.    from BULK devices.
  35.  
  36.   - Device stall could return improper value in the usbActCount field.  
  37.    This could make it impossible for drivers to attempt to recover from a 
  38.    pipe stall error. 
  39.  
  40.   - Workaround for potential data corruption with some OHCI controllers.  This 
  41.     problem shows up as corruption in transmitted high-speed data, following 
  42.     a low-speed input data transfer. 
  43.  
  44.   - Fixed problem with USB Services replacement that causes a crash after the 
  45.    "No Software" dialog is displayed in the case where there is a 
  46.    "USBFamilyExpert" extension in the system folder.
  47.  
  48.   - Hub attach delay.  We now wait, as per the USB Specification, the required 
  49.     100ms after a new device is attached to the hub before configuring it.  This 
  50.     should improve hot-plugging of devices (especially if sometimes they 
  51.     aren't detected).
  52.  
  53.   - Improved driver matching for compatibility shims.  The shims were 
  54.     matching on info from the driver, not info from the device.  This could 
  55.     cause some drivers not to be found by a shim.
  56.  
  57.   - Make sure ClassDrivers are locked to prevent VirtualMemory paging.  
  58.     This could potentially fix crashing problems on very busy systems.
  59.  
  60.   - Increased idle-queue size to 96.  We could potentially overflow this 
  61.     queue (and have things stop working) if there were too many devices 
  62.     attached.
  63.  
  64.   - Fixed several incorrect error returns in the PipeState functions.  
  65.  
  66.   - Fixed problem where a legal minimum config descriptor (a single 
  67.     configuration and interface) cause and error when attempting to find the 
  68.     interface.
  69.  
  70.   - Zero length transactions are allowed on the bus.
  71.  
  72.   - USL and UIM have to agree on a version number to work together. This
  73.     stops unmatched interfaces causing problems.
  74.  
  75.  
  76. Changes/Additions to the USB v1.0.1 DDK
  77. ---------------------------------------
  78. 1. Include the correct UniversalHIDModule class driver for use with 
  79.    Game Sprockets v1.3. Game Sprocket supported devices now work properly on
  80.    systems which use the Extension-based USB.
  81.  
  82. 2. Updated the PrinterClassSample so that the it fixes the 68K structure
  83.    alignment problem. Also modified the code so that the DRVR and 
  84.    NameRegistry items are removed, when the class module unloads.
  85.  
  86. 3. Includes a draft release of the Technote "Writing USB Drivers".
  87.  
  88. 4. Added the USBModem example, however, at this time, there is no CodeWarrior
  89.    project file. In the next release of the DDK, this issue will be addressed.
  90.  
  91. Known Issues
  92. ------------
  93.  
  94. 1. In the Mac OS USB API Reference Guide, the description for USBFindNextPipe
  95.    is incomplete. The parameter block fields, buffer, actcount and reqcount 
  96.    must be initialized to zero for this call to work.